


                            PAS2HTML 2.2

                  Pascal Source to HTML Converter




      PAS2HTML was written by Pieter Polak (e-mail: pp@coas.com)
          Copyrights(c)1996,97 by COAS, All rights reserved.




PAS2HTML is a conversion program which translates Delphi Pascal source files
into HTML format with Borland Delphi compatible syntax highlighting. This
makes it very easy to publish source code on the Web in a clear way. If you
have ever tried to create a HTML page containing highlighted source you know
how much work this can be.


The contents of the package
===========================

The distribution archive of Pas2HTML contains four different versions of the
program which all rely on the same conversion engine:

PAS2HTML.EXE  - This is the original DOS 16-bit command line tool which
                gives you the posibility to convert your Pascal source files
                into HTML. You also specify wildcards to do batch conversions.
P2HWIN.EXE    - This is the 32-bit Windows version of the program. This tool
                will operate like a simple wizard, which allows you to specify
                a file or group of files to be converted. You can run this
                program on Windows 3.1 as well, after you have installed
                Win32s (version 1.30).
P2HEXP16.DLL  - This is the 16-bit Delphi expert which can be installed into
                the Delphi 1.0 IDE. This expert adds a menu item in the Help
                menu called 'Pascal to HTML', and shows the conversion wizard
                which allows you to convert every file from you project.
P2HEXP32.DLL  - This file is identical to the former file, but it is the 32-bit
                version. You can use this expert with Delphi 2.0.
P2HCGI.EXE    - This is a 32-bit executable which generates output suitable to
                be used as a CGI application on you WEB server. You can include
                links to Pascal files from your HTML pages using links like
                this: <A HREF="/cgi-bin/p2hcgi.exe?e:\public\pas\test.pas">,
                assuming you have copied P2HCGI.EXE to the /cgi-bin directory
                on your WEB server.
                You can use this program on any WEB server running on
                Windows NT which supports CGI (e.g. from Netscape or Microsoft).
P2HISAPI.DLL  - This is a 32-bit DLL which provides the same functionality
                as the CGI version, but this one is an ISAPI version. You
                can use it on a WEB server running Microsoft's IIS to
                achieve a much better performance than with CGI. A link to
                a Pascal source file using this DLL will look like this:
                <A HREF="/scrips/p2hisapi.dll?e:\public\pas\test.pas">,
                assuming you have copied the .DLL file to the scripts directory
                on your WEB server.


Installation of the Delphi experts
==================================

To install the Delphi 1.0 expert, please folow these steps:
  1. Install the contents of the package into a directory on your hardddisk
     (e.g. C:\PAS2HTML).
  2. Go to you WINDOWS directory (e.g. C:\WINDOWS).
  3. Open DELPHI.INI in your favourite editor, and search for the
     [Experts] section. If you can not find this section: create it.
  4. Add the folowing line to this section:
       P2HExp16=C:\PAS2HTML\P2HEXP16.DLL
After you have added this line, save the DELPHI.INI file and start/restart
Delphi. Pas2HTML can be started from the Help menu.

To install the Delphi 2.0 expert, please folow these steps:
  1. Install the contents of the package into a directory on your hardddisk
     (e.g. C:\PAS2HTML).
  2. Start the registry editor (run REGEDIT in your Windows directory,
     Windows/NT 3.x users should use REGEDT32).
  3. Go to the folowing key:
       HKEY_CURRENT_USER\Software\Borland\Delphi\2.0\Experts
  4. Add the folowing string variable to this key:
       P2HExp32=C:\PAS2HTML\P2HExp32.DLL
After you have done this, you can close the registry editor, and start/restart
Delphi. Pas2HTML can be started from the Help menu.


New versions
============

New versions of the program will become available via the Pas2HTML homepage
at http://www.coas.com/pas2html, and at the Borland Delphi 32 forum at
CompuServe (GO BDELPHI32).


Problems?
=========

When you have any questions about the program or find any bugs, you can
contact me via e-mail at pp@coas.com or via Compuserve at 75512,3404.


Registration
============

The command line version of Pascal to HTML is a free tool. If you want to
use the Windows interface version for a period longer than 30 days, you
should register. The registration fee for Pas2HTML is US$ 22.00 and can
be done by going to the SWREG forum on CompuServe (use ID #14568 to find the
program or search for pas2html). Once you have registered you will receive
the user-friendly Windows version of the program, which also alows you to
adjust the colors and attributes used for the syntax highlighting.


Version history:
================
2.2  - Added a Delphi expert to the package (both 16 and 32 bit versions are
       included).
     - Fixed a minor bug in the ISAPI version.
2.1b - Fixed a minor bug in the commandline DOS version.
     - Optimized the conversion process in the Windows version.
     - Changed the icon of the Windows version.
2.1a - Added support for new keywords found in Delphi 3.0.
2.1  - The folowing things were changed:
        - Ported the Windows version to 32-bit so it supports long filenames.
        - HTML output is configurable in the registered version.
        - Changed the help text in both the CGI and ISAPI versions.
     - Fixed the folowing bugs:
        - Changed the ISAPI converter since it hangs when using files larger
          then 1024 bytes.
2.0a - Added support for new keywords found in Delphi 3.0.
2.0  - Fixed the folowing bugs:
        - Added correct handling of the Delphi 2.0 style // comments.
        - Changed the HTML output to achieve better compatibility with
          older WEB browser versions.
       Added the folowing new features:
        - A 16-bit windows version has been added.
        - An ISAPI WEB server version has been added.
       Added the folowing features to the registered version:
        - You can specify not to include the standard header and or footer.
1.0  - The initial release of the command line conversion tool.

